.. vim: syntax=rst
Chapter 5: Output Files and Options
===================================
Basic Guidelines for Using Output Files.
-----------------------------------------
During the flood simulation, the user has two choices for viewing the model flood progression:
1. An output text screen
2. A graphical representation of the flood simulation.
The screen option is selected with the LGPLOT variable in the CONT.DAT file.
The text screen scrolls a list of the simulation time, minimum timestep and the volume conservation data.
This screen enables the user to view the simulation runtime speed and the volume conservation.
The second screen option is a color graphics display of the grid element flow depth (area of inundation) along with the
inflow hydrograph.
After the flood simulation is complete, the hydraulic results are presented in output files that contain hydrographs,
maximum flow depths and velocities.
The conservation of flood volume (inflow equals outflow plus storage) should be reviewed for each simulation.
A summary of the inflow volume, final volumes left on the floodplain (storage) and outflow from the grid system is
presented in the SUMMARY.OUT file.
Output files are created with both spatial and temporal formats.
Output files that are listed in the order of the output intervals are temporal output and output files listed in the order of the grid elements is
spatial output.
Output data include water surface elevation, flow depth, velocity, discharge, impact pressure, specific energy,
sediment concentration and other variables.
Overland flow hydraulics may be viewed as individual grid elements or the grid elements can be grouped together to produce floodplain cross-sections.
Summary tables listing maximum velocity and flow depths and their times of occurrence appear at the end of the BASE.OUT file.
Review the CONT.DAT file description in Chapter 4 for more information about specifying output file formats.
The user is cautioned about specifying the output in too much detail which can result in extremely large output files.
The output time interval TOUT and NOPRTFP options in the CONT.DAT file can be assigned to limit the size of the output files.
When NOPRTFP is set to 0, all the floodplain output data is written to the BASE.OUT file for each output interval.
Setting NOPRTFP = 2 will turn off all of the temporal floodplain hydraulic output data.
The user does not have to specify any output file names.
It is important to note that each time the model is run, it will write over the existing output files and the previous
output file data will be lost.
To save any output files in anticipation of subsequent simulation, the user should create another subdirectory.
Use NotePad© , NotePad++© or any other ASCII editor to view the output files.
A brief description of all the output files follows:
*Table 5.1.
List of General \*.OUT Files and Unit Numbers*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 2
- BASE.OUT
- 19
- TIME.OUT
* - 11
- SUMMARY.OUT
- 55
- SURFAREA.OUT
*Table 5.2.
List of 2-D Overland Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - Depth
-
- Velocity
-
* - 20
- DEPTH.OUT
- 118
- VELTIMEFP.OUT
* - 27
- DEPTHTOL.OUT
- 641
- VELRESMAX.OUT
* - 28
- DEPTHDUR.OUT
- 81
- FINALVEL.OUT
* - 62
- FINALDEP.OUT
- 83
- FINALDIR.OUT
* - 60
- DEPFP.OUT
- 63
- VELDIREC.OUT
* - General
-
- 64
- VELFP.OUT
* - 45
- FLOODWAY.OUT
- 1401
- VEL_X_DEPTH.OUT
* - 101
- IMPACT.OUT
- Discharge
-
* - 102
- STATICPRESS.OUT
- 105
- MAXQHYD.OUT
* - 289
- INFIL_DEPTH.OUT
- 106
- MAXQBYDIR.OUT
* - 82
- OUTNQ.OUT
- 107
- MAXQRESOLVED.OUT
* - 92
- INTERGWS.OUT
- 124
- MAXWSELEV.OUT
* - 67
- INFILHY.OUT
- Time
-
* - 104
- SPECENERGY.OUT
- 21
- TIMDEP.OUT
* - 111
- FPINFILTRATION.
- 78
- TIMDEP_NC4.OUT
* - Review
-
- 181
- WSTIME.OUT
* - 1131
- EVACUATEDFP.OUT
- 190
- TIMETWOFT.OUT
* - 1597
- FLOODPLAIN_CONVERGENCE.OUT
- 191
- TIMETOPEAK.OUT
* - 1598
- DEPRESSED_ELEMENTS.OUT
- 192
- TIMEONEFT.OUT
* - 22
- ROUGH.OUT
- 193
- FLOODWAVETIME.OUT
* - 65
- SUPER.OUT
- 528
- DEPTHDUR2.OUT
* - 288
- BUILDING_COLLAPSE.OUT
- 1921
- TIME_TO_ABOVE_BASE-FLOW.OUT
* -
-
- 201
- BASEFLOWFP_TIME.OUT
*Table 5.3.
List of 1-D Channel Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 14
- CHANMAX.OUT
- 94
- XSEC.OUT
* - 24
- VELOC.OUT
- 103
- CONFLUENCE.OUT
* - 61
- DEPCH.OUT
- 140
- CHANSEDSIZE.OUT
* - 66
- CHVOLUME.OUT
- 113
- EVACUATEDCHAN.OUT
* - 74
- CHNBEDEL.OUT
- 117
- VELTIMEC.OUT
* - 80
- HYCHAN.OUT
- 261
- DEPCHFINAL.OUT
* - 87
- OVERBANK.OUT
- 262
- VELCHFINAL.OUT
* - 90
- CHANSTABILITY.OUT
- 263
- CHAN_INTERIOR\_NODES.OUT
* - 91
- XSECAREA.OUT
- 345
- CHANLOSSES.OUT
* - 93
- CHANWS.OUT
- 1596
- CHANNEL_CONVERGENCE.OUT
*Table 5.4.
List of Hydraulic Structures Output*
.. list-table::
:widths: 50 50
:header-rows: 0
* - **File No.**
- **File Name**
* - 70
- HYDROSTRUCT.OUT
* - 669
- HYDRAULIC STRUCTURE_RUNTIME WARNINGS.OUT
* - 910
- BRIDGE_FLOW_GEOMETRY.OUT
* - 912
- BRIDGE_DISCHARGE.OUT
* - 914
- BRIDGE_COEFFICIENTS.OUT
* - 671
- HYDRAULIC STRUCTURE SUBFACTORS.OUT
*Table 5.5.
List of Levee and Breach Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 59
- LEVEE.OUT
- 1594
- LOW_LEVEE_CREST_ELEVATIONS.OUT
* - 160
- LEVOVERTOP.OUT
- 1601
- LEVOVERTOPMAX.OUT
* - 161
- LEVEEDEFIC.OUT
- 1779
- CVFPMAX.OUT
* - 255
- BREACH.OUT
- GE#
- GE#_LEVFAIL.OUT
* - 1132
- DAMBREACH_VOLUME.OUT
- 699
- PRESCRIBED_BREACHQ.OUT
*Table 5.6.
List of Storm Drain Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 1560
- SWMMQIN.OUT
- 1574
- MANHOLEPOP.OUT
* - 1565
- SWMMOUTFIN.OUT
-
- SWMM.RPT
* - 1563
- FPRIMELEV.OUT
-
- SWMM.OUT
* - 1570
- SD MANHOLEPOPUP.OUT
-
-
*Table 5.7.
List of Multiple Channel Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 25
- MULTCHN.OUT
-
-
* - 205
- MULTSTEEP.OUT
-
-
*Table 5.8.
List of Sediment Transport and Mudflow Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 17
- SEDFP.OUT
- 88
- SEDTRAN.OUT
* - 18
- SEDCHAN.OUT
- 139
- FPSEDSIZE.OUT
* - 77
- SEDCONSERV.OUT
-
-
*Table 5.9.
List of Two Phase Flow Output*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 241
- VELOC_MUD.OUT
- 831
- FINALDIR_MUD.OUT
* - 242
- CVTMAX.OUT
- 811
- FINALVEL_MUD.OUT
* - 243
- CVTMAX_MUD.OUT
- 1771
- FP_BED_CHANGE_MUD.OUT
* - 245
- CVTFINAL_MUD.OUT
- 1773
- CVFPMAX.OUT
* - 361
- DEPCHFINAL_MUD.OUT
- 1775
- FINALCVFP_MUD.OUT
* - 602
- DEPFPMAX_MUD.OUT
- 1779
- CVFPMAX_MUD.OUT
* - 603
- DEPTHMAX_2PHASE_COMBINED.OUT
- 2070
- 2 PHASE SEDIMENT VOLUME CONSERVATION.OUT
* - 611
- DEPCH_MUD.OUT
- 2080
- FPWSEL_MUD.OUT
* - 622
- FINALDEP_COMBO.OUT
- 6411
- VELFP_MUD.OUT
* - 621
- FINALDEP_MUD.OUT
- 6412
- VELRESMAX_MUD.OUT
* - 631
- VELDIREC_MUD.OUT
-
-
*Table 5.10.
List of MODFLOW Output*
.. list-table::
:widths: 50 50
:header-rows: 0
* - **File No.**
- **File Name**
* - 1238
- MODFLOW FP INFILTRATION VOLUMES.OUT
* - 1239
- MODFLOW FP INFILTRATION TOTALS.OUT
* - 1241
- MODFLOW CHANNEL INFILTRATION TOTALS.OUT
* - 1242
- FLO-2D MODFLOW FP RETURN EXCHANGE.OUT
* - 1243
- FLO-2D MODFLOW CH RETURN EXCHANGE.OUT
* - 1244
- FPMODFLOWELEV.OUT
* - 1245
- CHMODFLOWELEV.OUT
* - 12466
- FLO-2D MODFLOW INFILTRATION.OUT
* - 12477
- MODFLOW FLO-2D RECHARGE.OUT
*Table 5.11.
List of \*.RHG Files and Unit Numbers*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 108
- FPLAIN.RGH
- 109
- CHAN.RGH
* - 110
- STREET.RGH
- 208
- MULT.RGH
* - 309
- MANNINGS_N.RGH
- 1572
- FPLAIN_SDELEV.RGH
* - 1573
- TOPO_SDELEV.RGH
- 2229
- STEEPROUGH.RGH
*Table 5.12.
List of Batch Files and Unit Numbers*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 195
- DEPFP_ANTERIOR.OUT
- 213
- DIFF_VELOC.OUT
* - 196
- DIFF_DEPFP.OUT
- 214 \
- VELTIMEFP_ANTERIOR.OUT
* - 197
- FINALDEP_ANTERIOR.OUT
- 215
- DIFF_VELTIMEFP.OUT
* - 198
- DIFF_FINALDEP.OUT
- 216
- VELTIMEC_ANTERIOR.OUT
* - 199
- ENDRUNBATCHTEST.OUT
- 217
- DIFF_VELTIMEC.OUT
* - 206
- VELFP_ANTERIOR.OUT
- 218
- DEPCH_ANTERIOR.OUT
* - 207
- DIFF_VELFP.OUT
- 219
- DIFF_DEPCH.OUT
* - 209
- DEPTH_ANTERIOR.OUT
- 220
- DEPCHFINAL_ANTERIOR.OUT
* - 210
- DIFF_DEPTH.OUT
- 221
- DIFF_DEPCHFINAL.OUT
* - 212
- VELOC_ANTERIOR.OUT
-
-
*Table 5.13.
List of \*.TMP Files and Unit Numbers*
.. list-table::
:widths: 25 25 25 25
:header-rows: 0
* - **File No.**
- **File Name**
- **File No.**
- **File Name**
* - 8
- CHMAX2.TMP
- 112
- OUTNQMAX.TMP
* - 12
- OUTNQ.TMP
- 122
- HYSTREET.TMP
* - 13
- HYCHAN.TMP
- 159
- LEVOVERTOP.TMP
* - 15
- HYCROSS.TMP
- 254
- BREACH.TMP
* - 16
- CROSSQ.TMP
- 1561
- SWMMQIN.TMP
* - 71
- HYDROSTRUCT.TMP
- 1566
- SWMMOUTFIN.TMP
* - 76
- OUTNQ2.TMP
-
-
2 PHASE SEDIMENT VOLUME CONSERVATION.OUT
Summary of the final disposition of the sediment volume.
**BASE.OUT**
BASE.OUT is an all-inclusive output file.
At the beginning of the file, the inflow hydrographs are printed, then the time dependent output data follows.
For each specified time output interval, the flow depth, velocity, water surface elevation and discharge for either
the channel or the floodplain grid elements can be written.
The outflow from the boundary grid elements is listed at the end of the time interval.
After the final time output interval, a summary of all the grid elements maximum depths, water surface elevations,
velocities and the time of occurrence of the maximum values is printed.
Finally, a summary table of the inflow, outflow and storage volumes at the end of the file allows the user to review
the conservation of mass and the ultimate disposition of all the water and sediment.
For convenience, this conservation table is also written to a separate output file named SUMMARY.OUT that is more complete.
There is so much output data in the BASE.OUT file that the user is encouraged to avoid generating this file.
All of the text output in this file is provided in individual ASCII xyz output files for plotting purposes and the user will probably have little
interest in the BASE.OUT format of the floodplain hydraulics for the individual grid elements.
This output file can become large and it takes too long to write to it for models with 500,000 grid elements or more.
Set NOPRTFP = 2 and it will not be created:
- If NOPRTFP = 0, all the BASE.OUT floodplain flow data is reported.
- If NOPRTFP = 1, the BASE.OUT floodplain outflow data is not reported.
- If NOPRTFP = 2, the entire file is not created.
- If NOPRTFP = 3, only floodplain outflow data is repIf NOPRTFP = 3, only floodplain outflow data is reported to the BASE.OUT file.
**BASEFLOWFP_TIME.OUT**
This file provides an option to report the time when the discharge exceeds the floodplain base flow has been implemented.
The BASEFLOWFP\_ TIME.OUT file reports the following data.
- Grid
- Xcoord
- Ycoord
- Time to above baseflow (hrs)
With this output file from a second simulation, the arrival time of an overland floodwave overtaking a base flow is reported.
A similar option was coded for channel base flow (uses a B-line with the baseflow in CHAN.
DAT on a channel segment basis).
The IFLOODWAVE switch is not necessary for reporting the time when the discharge exceeds the channel baseflow.
The reporting is activated by the CHAN.DAT B-line.
The floodplain time above baseflow reporting option requires 2 two simulations: 1) Set IFLOODWAVE = 0 in CONT.DAT
and prepare INFLOW.
DAT with only the base flow hydrographs and run the model.
2) Set IFLOODWAVE = 2 and swap out the INFLOW.DAT file with the flood hydrograph (such as a dam breach hydrograph) and run the model a second time
to generate the BASEFLOWFP_TIME.OUT file.
BATCH COMPARISON FILES
Running the batch processor will execute many projects in series and perform automatic comparisons of the output data from previous runs.
The following files represent the comparison dataset:
- DEPFP_ANTERIOR.OUT
- DIFF_DEPFP.OUT
- FINALDEP_ANTERIOR.OUT
- DIFF_FINALDEP.OUT
- ENDRUNBATCHTEST.OUT
- VELFP_ANTERIOR.OUT
- DIFF_VELFP.OUT
- DEPTH_ANTERIOR.OUT
- DIFF_DEPTH.OUT
- VELOC_ANTERIOR.OUT
- DIFF_VELOC.O
- DIFF_DEPTH.OUT
- VELOC_ANTERIOR.OUT
- DIFF_VELOC.OUT
- VELTIMEFP_ANTERIOR.OUT
- DIFF_VELTIMEFP.OUT
- VELTIMEC_ANTERIOR.OUT
- DIFF_VELTIMEC.OUT
- DEPCH_ANTERIOR.OUT
- DIFF_DEPCH.OUT
- DEPCHFINAL_ANTERIOR.OUT
- DIFF_DEPCHFINAL.OUT
BINARY FILES
The following binary backup files are generated when IBACKUP = 1.
These files can be used to restart model after termination (either interrupted simulation or end of the simulation).
- CHANBINARY.OUT
- CROSSBINARY.OUT
- FPLAINBINARY.OUT
- HYSTRUCBINARY.OUT
- SEDBINARY.OUT
- STREETBINARY.OUT
- VOLUMEBINARY.OUT
- XSECSEDBINARY.OUT
**BREACH.OUT**
This file is generated when the erosion breach routine is activated for dams or levees.
The output is listed by grid element number with singular and tabular results.
The initial and peak discharge is reported for each grid element and the time each occurred.
The failure node, direction, start time, start discharge, peak discharge, and peak time are reported on lines 2 and 3.
This is followed by the tabular data.
The tabular data is reported for the breach discharge as follows:
- Time (hrs) - simulation time output
- Direction - breach direction 1-8 grid element directions
- Breach Q - total discharge through the breach and the end of the interval (cfs or cms)
- Sediment discharge - total sediment through the breach at the end of the interval (cfs or cms)
- Sediment concentration - concentration of sediment in the breach
- Bottom width - breach width at the bottom of the dam or levee at the output interval (ft or m)
- Top width - breach width at the top of the dam or levee at the output interval (ft or m)
- Breach elevalevee at the output interval (ft or m)
- Breach elevation - elevation of the bottom of the breach at the output interval (ft or m)
**BRIDGE_COEFFICIENTS.OUT**
This file has the various discharge coefficients that are selected or computed:
- Time
- Inflow node
- COEFFREEB(JB)
- COEFFPRIME(JB)
- KFB(JB)
- KWWB(JB)
- KPHIB(JB)
- KYB(JB)
- KXB(JB)
- KJB(JB)
**BRIDGE_DISCHARGE.OUT**
Bridge component output file.
- Time
- Inflow node
- Free surface Q (cfs or cms)
- Orifice flow Q (cfs or cms)
- Orifice and deck weir flow Q (cfs or cms)
**BRIDGE_FLOW_GEOMETRY.OUT**
Bridge flow area, wetted perimeter, and top width of the bridge cross-sections.
- US flow area (ft\ :sup:`2` or m\ :sup:`2`)
- US wetted perimeter (ft or m)
- US topwidth (ft or m)
- BR flow area (ft\ :sup:`2` or m\ :sup:`2`)
- BR wetted perimeter (ft or m)
- BR topwidth (ft or m)
- DS flow area (ft\ :sup:`2` or m\ :sup:`2`)
- DS wetted perimeter (ft or m)
- DS topwidth (ft or m)
**BUILDING_COLLAPSE.OUT**
This file lists the grid elements with full or partial ARF values that will be reset to 0.0 during the model run to
simulate the collapse and removal of buildings.
This occurs because the flood depth and velocity exceed the building collapse criteria.
The following tabular data is printed:
- Grid element
- Time
- Velocity - velocity at the time of collapse (fps or mps)
- Depth - depth at the time of collapse (ft or m)
- Minimum collapse depth based on the velocity (ft or m)
**CHAN_INTERIOR_NODES.OUT**
A list of all the grid elements between the channel bank elements representing the interior of the 1-D channel are
listed in this file.
These elements should reflecting the channel maximum depth when plotting maximum channel depths in FLO-2D MapCrafter.
The channel bank elements are not included in this file.
**CHANBANKEL.CHK**
This file reports the difference between the channel bank elevation and the grid element elevation for each assigned bank elements.
If the bank elevation difference exceeds the specified criteria, the floodplain elevation will be reset to channel bank elevation at runtime.
This assumes that the surveyed bank elevation is more accurate than the interpolated floodplain elevation.
The bank elevation difference criteria is:
- Channel grid element
- Xcoord
- Ycoord
- Bank elevation (ft or m)
- Floodplain elevation (ft or m)
- Difference (ft or m)
Channel bank elevation is different from the floodplain elevation by 1 ft or more.
If the slope associated with the bank elevation difference based on the grid element side width is greater than 0.01 (1%)
**CHANMAX.OUT**
The maximum discharge and stage for each channel element and the corresponding time of occurrence is written to this file.
This file is useful for finding channel cross-sections that might be surging.
If the timing if the maximum values do not correspond with the peak discharge, the channel element may be surging.
The following columns are written:
- Node
- Max Q - Maximum discharge for channel element (cfs or cms)
- Time - Time of Qmax
- Max Stage - Maximum stage for channel element (ft or m)
- Time - Time of max stage
**CHANNEL.CHK**
When the channel cross-section width exceeds the grid element width, the cross-section needs to extend into 1 or more neighboring elements.
When the channel surface area is 0.95 times the floodplain surface area the channel needs to extend into 1 or more neighboring elements.
This file lists the necessary extensions.
If a channel right bank is placed on an interior channel element, this file lists the bank that needs to be repositioned.
The file lists any channel / levee conflicts that may need to be fixed.
If the channel cross-section is R, T or V (non-natural cross-sections) and the channel is extended to more than one grid element and the bank
elevations are not assigned in CHAN.DAT.
This file lists the difference between the right and left channel bank elevations based on the floodplain elevations in two different bank elements.
**CHAN.RGH**
CHAN.RGH is a duplicate file of the CHAN.DAT file with the updated Manning’s n-value changes that were reported in the ROUGH.OUT file.
The maximum and final Manning’s n-value changes are listed in the ROUGH.OUT file.
To accept the changes to Manning’s n-values, CHAN.
RGH can be renamed to replace CHAN.DAT for the next FLO-2D flood simulation.
This automates the spatial adjustment of n-values for channel elements that exceed the limiting Froude number.
**CHANNEL_CONVERGENCE.OUT**
This file lists the channel elements that failed to converge in three passes of the routing algorithm.
The solution is then based on the diffusive wave for that element and timestep only.
The output files reports:
- Time - time of failed convergence
- Grid element
- Depth - depth at time of failed convergence (ft or m)
- Velocity - various velocity terms in the solution algorithm (fps or mps)
**CHANSEDSIZE.OUT**
The initial and final sediment size distribution by channel element is written to this file.
**CHANSTABILITY.OUT**
This output file lists the channel grid elements that experienced significant gains or losses of flow volume
(0.1 af or 100 m\ :sup:`3`).
These channel grid elements may have volume conservation stability problems that could be related to surging,
poorly matched roughness, slope and cross-section geometry or abrupt changes in cross-section geometry.
When the channel volume conservation for a simulation is not satisfactory, review this output file.
**CHANWS.OUT**
This output file lists channel grid element, x-coordinate, y-coordinate and maximum channel water surface elevation.
- Grid
- Xcoord
- Ycoord
- Water surface elevation (ft or m)
**CHMODFLOWELEV.OUT**
Comparison between channel cross-section cell elevation and MODFLOW grid elevation.
- Grid element
- Channel bed elevation (ft or m)
- Modflow column
- Modflow row
- Modflow bed elevation (ft or m)
- Elevation difference (ft or m)
**CHNBEDEL.OUT**
The channel grid element number and the final channel bed elevation are presented in this file.
- Grid element
- Elevation - final bed elevation (ft or m)
**CHVOLUME.OUT**
The channel volume distribution is listed in this output file including channel inflow, channel outflow, overbank flow,
return flow from the floodplain, infiltration, channel storage and storm drain return flow.
Review this file along with the SUMMARY.OUT to determine if the channel flow volume is being conserved.
- Time
- Inflow and rain - (acre ft or cm)
- Channel storage -Time
- Inflow and rain - (acre ft or cm)
- Channel storage - (acre ft or cm)
- Channel outflow - (acre ft or cm)
- Overbank outflow - (acre ft or cm)
- Return inflow - (acre ft or cm)
- Infiltration - (acre ft or cm)
- Evaporation - (acre ft or cm)
- Outflow to storm drain - (acre ft or cm)
- Inflow from storm drain - (acre ft or cm)
- Volume conservation - (acre ft or cm)
**CONFLUENCE.OUT**
This file lists the channel elements that constitute a confluence as defined by having three or more channel elements
contiguous to a given channel element.
**CROSSMAX.OUT**
When the floodplain cross-section analysis is requested by creating the FPXSEC.DAT file, the CROSSMAX.OUT is created.
This file lists the maximum discharge, maximum flow depth and time of occurrence for each grid element specified
in the cross-section analysis.
It also list the total volume in acre-ft for each cell.
**CROSSQ.OUT**
This file contains the grid element hydrographs for each of the floodplain elements in the cross-section.
The time and discharge are listed for each output interval.
- Time
- Discharge - hydrograph for grid element (cfs or cms)
**CVFPMAX.OUT**
This file contains the floodplain fluid maximum sediment concentration by volume.
- Grid element
- x-coord
- y-coord
- FP fluid max sediment concentration
- Time of FP fluid max concentration
**CVFPMAX_MUD.OUT**
This file contains the floodplain mudflow maximum sediment concentration by volume.
- Grid element
- x-coord
- y-coord
- FP mudflow max concentration
**CVTFINAL_MUD.OUT**
This file contains the floodplain final mudflow sediment concentration by volume.
- Grid element
- x-coord
- y-coord
- FP final mudflow concentration
**CVTMAX.OUT**
This file contains the channel fluid maximum sediment concentration by volume.
- Grid element
- x-coord
- y-coord
- Channel fluid max concentration
**CVTMAX_MUD.OUT**
This file contains the channel mudflow maximum sediment concentration by volume.
- Grid element
- x-coord
- y-coord
- channel mudflow max concentration
**DAMBREACH_VOLUME.OUT**
This file reports the cumulative dam breach volume in acre-ft or cubic meters by output interval.
- Time (hrs)
- Cumulative volume sediment (af or cm)
- Cumulative volume water (af or cm)
If MUD = 2 in CONT.DAT, these three lines are written at the end of the file.
- Total sediment volume through the breach (af or cm)
- Sediment volume left in reservoir (af or cm)
- Total sediment volume (af or cm)
**DEBUG.CHK**
An internal file for programmer debugging.
If this file is present, the user has access to the flopro.exe in debug mode.
Do not use this engine without instructions from developers.
**DEBUGXX.OUT**
This file reports all data related bugs and conflicts with an error code, grid element and a description of the error, warning or conflict.
It is imported by QGIS FLO-2D Plugin so users can visualize data error locations.
**DEPRESSED_ELEMENTS.OUT**
This file is generated at the end of the data input at runtime.
Every grid element elevation is checked with its neighbors’ elevations to see if it is depressed below the minimum difference of the DEPRESSDEPTH
variable in CONT.DAT and if so, it is listed in this file.
A value of DEPRESS- DEPTH = 3.0 ft is suggested which will help identify artificial ponded flow conditions.
This depth will ignore minor small depression elements which can fill and overview.
- Grid element
- Minimum elevation difference - lowest elevation difference between this element and its neighbors. (ft or m)
**Flow Depth Output Files**
A series of files are created by FLO-2D in the format: grid element number, x- and y-coordinates, and the maximum flow depth.
These files can be viewed with FLO-2D MapCrafter, MAXPLOT or programs or they can be imported to a CADD or GIS program to create maximum flood depth
contours.
The following output files are created:
- CHNBEDEL.OUT - Channel bed elevations DEPCH.OUT - Maximum channel flow depths DEPCHFINAL.OUT - Final channel flow depths DEPFP.OUT - Maximum
floodplain flow depths
- DEPTH.OUT - Maximum combined channel/floodplain flow depths DEPTHMAX_2PHASE_COMBINED.OUT - Maximum flow depth of the combined two phase fluid and
mudflows depth (added together).
- DEPTHTOL.OUT - Maximum combined channel and floodplain flow depths greater than the TOL value.
Values less than the TOL value are set to zero.
This file has the following format: x- and y- coordinates, and maximum flow depth.
No grid element numbers are included.
- FINALDEP.OUT - Final floodplain flow depths:
- Grid or Channel Left Bank Element
- Xcoord
- Ycoord
- Variable
**Flow Depth Output Files for TWO-PHASE modeling.**
- DEPCH_COMBO.OUT - Combined channel fluid and mudflow maximum flow depths.
Channel fluid or mudflow max depth (whichever is greater).
- DEPCH_MUD.OUT - Channel maximum mudflow depth.
- DEPCHFINAL_MUD.OUT - Channel final mudflow depth.
- DEPFPMAX_MUD.OUT - Floodplain maximum mudflow depth.
- FINALDEP_COMBO.OUT - Combined floodplain fluid and mudflow maximum flow depths.
Floodplain fluid or mudflow max depth (whichever is greater).
- FINDALDEP_MUD.OUT - Floodplain final mudflow depth.
For each file, only the Grid element number, coordinates and variables are listed.
- Grid or Channel Left Bank Element
- Xcoord
- Ycoord
- Variable
**DEPTHDUR.OUT and DEPTHDUR2.OUT**
- DEPTHDUR.OUT contains the floodplain inundation duration data including the grid element number, grid element x- and y-coordinates and duration of
inundation in hours.
The selected depth of inundation for which the duration (hrs) is computed is listed at the top of the file.
DEPTHDUR2.OUT is identical to DEPTHDUR.OUT except for a hardwired depth of 2 ft.
- Grid
- Xcoord
- Ycoord
- Time
**ERROR.CHK**
The ERROR.CHK file contains data input error and warning messages and some runtime error messages.
The backup data files (\*.BAC) can be reviewed with this file to determine if the input data is being read properly at runtime.
When a simulation terminates immediately after being started, check this file first for data input errors.
This file is defined in more detail in the troubleshooting section chapter 7.
**EVACUATEDCHAN.OUT**
The channel elements that experience a complete evacuation of the channel volume are listed in this output file.
The channel elements in this file should be cross-correlated with those listed in TIME.OUT and VELTIMEC.OUT files.
- Element
- Number of evacuations
**EVACUATEDFP.OUT**
The floodplain elements that experience a complete evacuation of the floodplain volume are listed in this output file.
The floodplain elements in this file should be cross-correlated with those preeminently listed in TIME.
OUT and VELTIMEFP.OUT files.
- Element
- Number of evacuations
**FINALCVFP_MUD.OUT**
This file contains the final floodplain mudflow sediment concentration by volume.
- Grid
- Xcoord
- Ycoord
- Floodplain final mudflow max concentration.
**FLO-2D MODFLOW CH RETURN EXCHANGE.OUT**
Exchanged volume and corrected water surface elevation calculated based on the MODFLOW volume returning to surface for CH cells.
- Time
- Grid element
- CH grid element
- CH depth (ft or m)
- Water exchange · · · CH CH grid element
- CH depth (ft or m)
- Water exchange volume (ft\ :sup:`3` or m\ :sup:`3`)
- Grid area (ft\ :sup:`2` or m\ :sup:`2`)
- Groundwater volume to surface (ft\ :sup:`3` or m\ :sup:`3`)
- Column
- Row
- Ground water depth (ft or m)
- Added depth to CH bed elevation (ft or m)
**FLO-2D MODFLOW FP RETURN EXCHANGE.OUT**
Exchanged volume and corrected water surface elevation calculated based on the MODFLOW volume returning to surface for FP cells.
- Time
- Grid element
- Surface depth (ft or m)
- Corrected surface depth (ft or m)
- Grid area (ft\ :sup:`2` or m\ :sup:`2`)
- Groundwater volume to surface (ft\ :sup:`3` or m\ :sup:`3`)
- Column
- Row
- Ground water depth above surface depth (ft or m)
**FLOODPLAIN_CONVERGENCE.OUT**
This file lists the floodplain elements that failed to converge in three passes of the routing algorithm.
The solution is then based on the diffusive wave for that element and timestep only.
The output files reports:
- Time - time of failed convergence
- Grid element
- Depth - depth at time of failed convergence (ft or m)
- Velocity - various velocity terms in the solution algorithm (fps or mps)
**FLOODWAVETIME.OUT**
This file contains the following output:
.. raw:: html
Node X-coord Y-coord Floodwave Arrival Time Flood Time Peak
Time Deflood Time Max WS
Each grid element is assigned a specific value of the above parameters at the end of the simulation.
The maximum values are tracked during the simulation on a computational timestep basis.
The following parameter definitions are used:
- Floodwave Arrival Time: Time in hours from when the breach discharge exceeds 0.01 cfs or cms to when the floodplain grid element flow depth exceeds
1 ft or 0.3 m.
If the grid element has a channel assignment, the time when the channel flow depth becomes one foot higher than the base
flow (when breach discharge > 0.01 cfs or cms) is reported.
- Flood Time: Time (hours) from when the breach discharge exceeds 0.01 (cfs or cms) to when a given grid element flow depth exceeds 2.0 ft or 0.67 m
on the floodplain.
If the grid element has a channel assignment, the time to when the flow exceeds the lowest top of bank is reported.
- Peak Time: Time (hours) from when the breach discharge exceeds 0.01 (cfs or cms) to when a given grid element flow depth reaches a maximum depth.
If the grid element has a channel assignment, the time to when the channel flow reaches a maximum depth is reported.
- Deflood Time: The time elapsed from the initial failure of the dam until the grid element returns to its pre-flood water elevation (0.1ft) prior to
failure.
The dam breach initialization is based on the first incremental change in flow depth greater than the tolerance value (TOL).
- Max WS: The maximum water surface elevation for a given floodplain grid element is reported.
If a channel is assigned to the grid element, the maximum water surface elevation for either the channel or the floodplain is reported.
**FLOODWAY.OUT**
FLOODWAY.OUT is written when IFLOODWAY = 0.
This file lists the grid element and the maximum floodplain water surface elevation.
Following the base flood simulation in which FLOODWAY.OUT is written, the then user sets IFLOODWAY = 1 and assigns a value for ENCROACH in CONT.DAT.
For a floodway simulation, the model reads FLOODWAY.
OUT and does not share discharge between floodplain elements until the computed water surface in FLOODWAY.OUT plus the ENCROACH value is exceeded for
a given grid element.
See the FLO-2D Reference Manual for a discussion on the floodway routine.
**FPINFILTRATION.OUT**
The total infiltration (ft or m) at the end of the simulation for each floodplain element is written to this file with grid element x- and
y-coordinates.
- Grid element
- Xcoord
- Ycoord
- Total infiltration (ft or m)
**FPMODFLOWELEV.OUT**
Comparison between FP grid cells elevation and Modflow grid elevations.
- Grid element
- Elevation
- Modflow column
- Modflow row
- Modflow elevation
- Elevation difference
**FPREV.NEW**
This output file reports the differences in elevation between the rim elevation in the SWMM.inp file and the FLO-2D grid element elevation.
This file should be reviewed to evaluate the elevations representing the inlet reference elevation.
- Grid element
- New grid element elevation (ft or m)
**FPRIMELEV.OUT**
This output file reports the differences in elevation between the rim elevation in the SWMM.inp file and the FLO-2D grid element elevation.
This file should be reviewed to evaluate the elevations representing the inlet reference elevation.
- Grid element
- Floodplain elevation - grid element elevation (ft or m)
- Rim elevation - rim elevation of storm drain inlet or manhole (ft or m)
- Difference (ft or m)
- New floodplain elevation - elevation the model uses (ft or m)
**FPLAIN.RGH**
This file contains the final Manning’s n-value changes for the floodplain grid elements.
The maximum and final Manning’s n-values are reported in the ROUGH.OUT.
If the changes are acceptable, FPLAIN.RGH can be renamed to FPLAIN.DAT for the next FLO-2D flood simulation.
This automates the spatial adjustment of n-values for floodplain elements that exceed the limiting Froude number.
**FPLAIN_SDELEV.RGH**
This file contains the elevation adjustments that were automatically corrected when the FLO-2D engine compared the floodplain grid elements to the
storm drain rim and type 4 invert elevations.
To fully accept the changes reported to fprimelev.new, replace FPLAIN.DAT with this file.
It is also necessary to replace the TOPO.DAT with TOPO_SDELEV.RGH.
**FPSEDSIZE.OUT**
The initial and final sediment size distribution for the floodplain grid element is written to this file.
The file is arranged in tables by grid element.
- Grid element
- Sediment diameter.(mm)
- Percent finer initial
- Percent finer final
**HDF5_ERROR.CHK**
The HDF5_ERROR.CHK file contains error comments for the HDF5 input data and output results.
HDF5 input file and output file are created when IBACKUP equal to 3 in the CON.DAT file.
All data and output errors for HDF5 structure that are encountered before or at execution time are listed in this file.
When a simulation terminates immediately after being started, check all CHK files for errors.
**HYCHAN.OUT**
This channel hydraulics output file contains a hydrograph for each channel element and includes the time, elevation, depth, velocity, discharge and
sediment concentration.
The maximum discharge and stage are also listed with their times of occurrence.
The following columns are printed for each channel element.
- Time - output interval
- Elevation – water surface elevation starting at bed elevation.
- Thalweg depth - average depth above the lowest point in the channel for the duration of the output interval.
(ft or m)
- Velocity - depth average velocity for cross-section for the duration of the output interval (fps or mps)
- Discharge - average discharge for the output interval (cfs or cms)
- Froude number - based on the average depth and velocity.
- Flow area - average flow area given by the average discharge divided by the average velocity (sqft or sqm)
- Wetted Perimeter - average wetted perimeter for the cross-section for the duration of the output interval (ft or m)
- Hydraulic radius average flow area divided the average wetted perimeter (ft or m)
- Top width - average top width for the duration of the output interval (ft or m)
- Width to depth ratio - average width divided by the average depth
- Energy slope - average water surface head plus the average velocity head divided by the length of the channel between grid
element centers
- Bed shear stress - average energy slope times the average hydraulic radius times gamma (specific weight of water)
- Surface area - average surface area of the channel (top width times channel length) for the duration of the output interval (sqft or sqm)
**HYCROSS.OUT**
The output interval time, top width, depth, velocity and discharge are listed for each cross-section.
The discharge passing the cross-section of grid elements is compiled as a hydrograph.
The cross-section maximum discharge and the individual grid elements are written to the CROSSMAX.OUT file..
- Time
- Flow width - distance between the first and last node (ft or m)
- Depth - average depth across the complete cross-section (ft or m)
- Watersurface elevation (ft or m)
- Velocity - average velocity for the complete cross-section (fps or mps)
- Discharge - resolved and compiled discharge for the complete cross-section.
This is the most important value (cfs or cms).
If mudflow is used, this is the total water discharge including mudflow concentration.
- Concentration by volume - mudflow concentration is written as output when mudflow or two phase mudflow is used.
**HYDROALL.OUT**
This file is generated by the HYDROG.EXE.
It is used internally and not by the end user.
**HYDRAULIC STRUCTURE SUBFACTORS.OUT**
The discharge hydrographs of all the hydraulic structures is presented in this output file.
This file lists time and the discharge seen an the inlet and at the outlet for each hydraulic structure.
If the values are negative in the inlet, the water is moving from the outlet to the inlet as backwater.
If the discharge varies wildly, there could be surging.
The rating table or curve might not match the cross-sectional areas adjacent to the structures.
- GE
- Name
- Time
- Upstream watersurface elevation
- Downstream watersurface elevation
- Upstream depth
- Downstream depth
- Discharge
- Subfactor
**HYDROSTRUCT.OUT**
The discharge hydrographs of all the hydraulic structures is presented in this output file.
This file lists time and the discharge seen an the inlet and at the outlet for each hydraulic structure.
If the values are negative in the inlet, the water is moving from the outlet to the inlet as backwater.
If the discharge varies wildly, there could be surging.
The rating table or curve might not match the cross-sectional areas adjacent to the structures.
- Time
- Discharge inlet
- Discharge outlet
**HYSTREET.OUT**
The street flow hydrograph for the grid element that is coincidental to the street and the cross-section is recorded
in this file.
**IMPACT.OUT**
The units are pounds force per foot (newton per linear meter).
This is the impact force on a wall or feature of a unit length.
Multiple by the length of the cell or the length of the dump to get the total maximum impact force on the feature.
Please note that this would be an impact force if the maximum velocity were instantaneous on the wall or feature as
in a frontal wave.
If the flow gradually increases on the wall and the maximum velocity occurs with the flow going over the wall or feature then the impact force will be
mitigated.
The conservative approach to the impact force would consider that the maximum velocity occurs in a frontal wave that would instantaneously stop.
As the impact force is a one-time instantaneous maximum value based on flow cessation is not temporally reported by output interval.
- Grid element
- Xcoord
- Ycoord
- Impact - lbf/ft or N/m
**INFILHY.OUT**
The hydraulic conductivities are listed in this file to review their spatial variation.
This file contains grid element number, x- and y-coordinates and floodplain hydraulic conductivity.
- Grid element
- Xcoord
- Ycoord
- Hydraulic conductivity
**INFIL_DEPTH.OUT**
This file will only write data if the limiting depth is used in the Green-Ampt infiltration calculator.
If the global soil depth is not set, the spatial data won’t be used and this file will be empty.
The file reports the soil depth in ft and infiltration depth in ft.
Once the infiltration reaches the limiting soil depth, the stop switch is activated and the infiltration is turned off for the specified grid element.
- Grid element
- Xcoord
- Ycoord
- Soil depth - assigned limiting infiltration soil depth (ft or m)
- Infiltration depth - total infiltration depth (ft or m)
- Stop - 0 or 1, where 1 = available infiltration depth was filled and infiltration stopped
**INTERGWS.OUT**
INTERGWS.OUT lists the maximum floodplain water surface elevations.
Values less than TOL are set to zero.
Only grid elements and maximum water surface elevations are listed; no coordinates are included.
- Grid element
- Water surface elevation (ft or m)
**LEVEE.HDF5**
The LEVEE.HDF5 file contains tables of breach data that are sorted by grid element number and output interval.
This file can be used to review the breach characteristics and flow through any direction of any grid element.
The data is reported at the output interval and per grid element.
Each row of data is joined by the Grid Element table.
This table lists the grid element number and fail direction.
Column 0 through Column 3 is North, East, South, West.
Column 4 through Column 7 is Northeast, Southeast, Southwest, Northwest.
- Breach elevation of the cutoff direction (ft or m)
- Discharge through the cutoff direction (cfs or cms)
- Failure width of the cutoff direction (ft or m)
.. image:: ../img/Data_Input_Manual_PRO_2025/Chapter5/DIM_Pro_2025_Chapter3_001.png
- Grid element listed for the failure direction (ft or m)
- Total Q sum of all Q for 10 timesteps (cfs or cms)
- Water surface Elevation at the failure direction (ft or m)
To use the data in this file, join the data tables by grid number and direction and then by time because multiple grid elements and directions are
reported for each output interval.
**LEVEE.OUT**
The LEVEE.OUT file contains a list of the grid elements with a levee that failed.
Failure width, failure elevation, discharge from the levee breach and the time of failure occurrence are listed.
The file shows failure expansion into multiple directions and adjacent levee elements.
The total breach is written to ge#_PRESCRIBED_BREACH.OUT.
This file also reports the time at which the breach reaches the bottom of the grid elevation and the flow for that direction changes from weir flow to
overland flow.
- Grid element
- Direction - fail direction 1-8
- Water surface elevation (ft or m)
- Breach elevation (ft or m)
- Failure width (ft or m)
- Discharge for cutoff direction (cfs or cms)
- Avg Q for 10 timesteps (cfs or cms)
- Time (hrs)
**LEVEEDEFIC.OUT**
The levee freeboard deficit is listed in this file.
Five levels of freeboard deficit are reported:
.. raw:: html
0 = freeboard > 3 ft (0.9 m)
1 = 2 ft (0.6 m) < freeboard < 3 ft (0.9 m)
2 = 1 ft (0.3 m) < freeboard < 2 ft (0.6 m)
3 = freeboard < 1 ft (0.3 m)
4 = levee is overtopped by flow.
- Grid element
- Xcoord
- Ycoord
- Levee deficit
**GE_LEVFAIL.OUT**
This file reports the levee failure expansion for a single grid element where the breach starts.
Do not use this file to try and understand the total failure because it is confined to a single grid element.
Use LEVEE.OUT to review prescribed breach expansion.
LEVEE.HDF5 also reports levee expansion for prescribed breach.
This file reports:
- Grid element
- Direction - fail direction 1-8
- Water surface elevation (ft or m)
- Breach elevation (ft or m)
- Failure width (ft or m) limited to one grid element
- Discharge for cutoff direction (cfs or cms)
- Avg Q for 10 timesteps (cfs or cms)
- Time (hrs)
**GE_PRESCRIBED_BREACH Q.OUT**
This file reports the breach discharge hydrograph in cubic feet per second or cubic meters per second through a dam or levee that was assigned
prescribed breach.
The grid element number indications the location where the breach initiated.
The discharge is total flow through all expansion elements.
- Time (hrs)
- Discharge (cfs or cms)
**LEVOVERTOP.OUT**
The discharge hydrograph overtopping the levee within the grid element is reported in this file.
Only those levee grid elements with a negative levee element number in LEVEE.DAT will be reported when overtopped.
The discharge is combined for all the potential levee overtopping directions for the grid element.
The rows of data are grouped by Grid element.
There is a row break when the Peak Q and Time are reported.
- Discharge total
- Time - time of overtopping,
- Discharge direction columns N, E, S, W, NE, SE, SW, NW.
Negative value means flow is moving from the opposite grid to the grid with the levee assigned.
**LEVOVERTOPMAX.OUT**
The max discharge of the water overtopping the levee within the grid element is reported in this file.
Only those levee grid elements with a negative levee element number in LEVEE.DAT will be reported when overtopped.
The discharge is combined for all the potential levee overtopping directions for the grid element.
- Grid element
- Discharge max (cfs or cms)
- Time of overtop minus overtop time (hrs)
**LOW_LEVEE_CREST_ELEVATIONS.OUT**
Levee crest elevations that are less than a minimum difference above the ground are list in this file.
The minimum elevation difference is the DEPRESSDEPTH parameter in the CONT.DAT file.
This variable is used to evaluate the minimum difference in the levee crest elevations compared to the ground elevation on both sides of the levee.
If used with DEPRESSED_ELEMENTS.OUT, the DEPRESSDEPTH variable either has to be the same value or two separate independent simulations are required
for different values (use SIMUL = 0.1 or 0.01 hrs for each).
- Grid element - element with the levee assigned
- Neighbor grid element - element across from the levee cutoff direction
- Direction - levee cutoff direction 1-8
- Levee crest elevation (ft or m)
- Ground elevation (ft or m)
- Elevation difference (ft or m)
**MANNINGS_N.RGH**
MANNINGS_N.RGH is a duplicate file of the MANNINGS_N.DAT file with the updated Manning’s n-value changes that were reported in the ROUGH.OUT file.
The maximum and final Manning’s n-value changes are listed in the ROUGH.OUT.
**MAXQBYDIR.OUT**
This output file lists the maximum floodplain grid element discharge according to the eight flow directions and the time of occurrence.
- Grid element
- North - Qmax (cfs or cms) Time
- NE - Qmax (cfs or cms) Time
- East - Qmax (cfs or cms) Time
- SE - Qmax (cfs or cms) Time
- South - Qmax (cfs or cms) Time
- SW - Qmax (cfs or cms) Time
- West - Qmax (cfs or cms) Time
- NW - Qmax (cfs or cms) Time
**MAXQHYD.OUT**
This output file lists the maximum floodplain grid element discharge and the associated hydraulics including:
- Grid element
- Time
- Maximum discharge (cfs or cms)
- Direction - direction max discharge was recorded 1-8
- Water surface
- Depth (ft or m)
- Velocity (fps or mps)
- Combined Qmax (cfs or cms)
- Direction - direction max velocity 1-8
**MAXQRESOLVED.OUT**
The maximum discharge resolved by flow direction listed for all eight flow directions regardless of the time of occurrence are reported to this file.
The resolved flow direction maximum discharge includes the sum of the primary flow direction and the two diagonal flow directions.
- Grid element
- North - Qmax (cfs or cms)
- Northeast - Qmax (cfs or cms)
- East - Qmax (cfs or cms)
- Southeast - Qmax (cfs or cms)
- South - Qmax (cfs or cms)
- Southwest - Qmax (cfs or cms)
- West - Qmax (cfs or cms)
- Northwest - Qmax (cfs or cms)
**MAXWSELEV.OUT**
Similar to DEPTH.OUT, this file contains grid element number, x-coordinate, y-coordinate, and the maximum water surface elevation of either the
floodplain or channel.
- Grid element
- Xcoord
- Ycoord
- Water surface elevation (ft or m)
**MODFLOW CHANNEL INFILTRATION TOTALS.OUT**
Total accumulated volume of water that infiltrates from the CH to MODFLOW at each MODFLOW timestep.
- Time
- Accumulated infiltration volume CH (ft\ :sup:`3` or m\ :sup:`3`)
**MODFLOW CHANNEL INFILTRATION VOLUMES.OUT**
Accumulated volume of water that infiltrates from CH to MODFLOW at each Modflow timestep and for each cell.
- Time
- Grid element
- Accumulated infiltration volume CH (ft\ :sup:`3` or m\ :sup:`3`)
**MODFLOW FP INFILTRATION TOTALS.OUT**
Total accumulated volume of water that infiltrates from the FP to MODFLOW at each MODFLOW timestep.
- Time
- Accumulated infiltration volume FP (ft\ :sup:`3` or m\ :sup:`3`)
**MODFLOW FP INFILTRATION VOLUMES.OUT**
Accumulated volume of water that infiltrates from FP to MODFLOW at each Modflow timestep and for each cell.
- Time
- Grid element
- Accumulated infiltration volume FP (ft\ :sup:`3` or m\ :sup:`3`)
**MULTCHN.OUT**
The multiple channel routine routes the overland flow between grid elements as concentrated channel flow (i.e. rill and gully flow).
For grid elements specified for multiple channel flow, overland flow only occurs within the grid element and the flow between the elements is conveyed
as gully flow.
Once the flow enters the multiple channels, the channel will enlarge to contain the flow.
This occurs when the flow depth exceeds the specified channel depth.
The channel increases by a specified incremental width.
After the peak discharge has passed and the flow depth is less than one foot, the channel width will decrease until it reaches the original width.
MULTCHN.OUT identifies multiple channel revisions including the maximum width, final width and the original width for each grid element.
The file has the following format:
- Grid element
- Max width (ft or m)
- Depth (ft or m)
- Qmax (cfs or cms)
- WSEL= Water Surface Elevation for each cell.
**MULTSTEEP.OUT**
This file lists the number of steep multiple channels found within the assigned minimum and maximum slopes.
**MULT.RGH**
MULT.RGH is a duplicate file of the MULT.DAT file with the updated Manning’s n-value changes that were reported in the ROUGH.OUT file.
The maximum and final Manning’s n-value changes are listed in the ROUGH.OUT.
**OUTNQ.OUT**
The OUTNQ.OUT file is separated into two data areas.
The first section contains a summary of the maximum discharge, time of peak and the discharge hydrograph for each floodplain outflow element.
The second section is column data that includes the following for each outflow node:
- Grid element
- Time (hrs)
- Discharge (cfs or cms)
**OVERBANK.OUT**
When the flow exceeds bankfull discharge and begins to inundate the floodplain, the channel grid element and time of overbank flood occurrence are
written to this file.
- Grid element
- Xcoord
- Ycoord
- Time
- Water surface elevation - elevation at time water goes overbank (ft or m)
- Thalweg depth - depth at time water goes overbank (ft or m)
- Velocity - average velocity at time water goes overbank (fps or mps)
- Discharge - q at time water goes overbank (cfs or cms)
- Overbank volume
- Available floodplain area
**RAINCELL.CHK**
This file was created for the user to be able check the magnitude of the average total rainfall for all grids and the total rainfall for each grid
during the simulation, the file contains the following:
.. raw:: html
Line 1 Average grid element rainfall for the entire storm=, RGRIDTOTALAVE
Line 2 1 to NNOD TOTAL RAINFALL
**RAINONECELL.CHK**
This is an internal file that I use for troubleshooting.
We need to make sure the unit is marked as used in the unit file list.
We eventually might want to let the user have access to this file.
**REVISED_RATING_TABLE.OUT**
This file reports suggested revisions to hydraulic structure rating tables based on the inflow discharge to the hydraulic structure inlet floodplain
or channel element.
These revisions are usually the result of the rating table being created with low n-values or because the rating table has insufficient low depth
stage-discharge pairs or the cross-section do not match the rating table data.
**ROUGH.OUT**
The ROUGH.OUT file reports the automated Manning’s n-value adjustment during model simulation including n-value change for exceeding the Courant
number and exceeding the limiting Froude.
The user specifies a maximum Froude number for overland, channel and street flow.
When the computed Froude number exceeds the defined maximum value for a given grid element, the n-value for that grid element is increased by a value
based on the percent change in the n-value.
During the falling limb of the hydrograph when the Froude number is no longer exceeded, the n-value is decreased by 0.0005 until the original n-value
is reached.
When the Courant number timestep is exceeded consecutive times by the same grid element, then n-value is also increased.
With increasing consecutive timestep decrements, the increase in n-value decreases.
The maximum n-value, time of occurrence, and original n-values for floodplain, channel and street are listed in ROUGH.OUT by grid element.
**SD MANHOLEPOPUP.OUT**
SDManholePopUp.OUT is created when at least one manhole pops in the storm drain system.
This file contains the following information:
- Xcoord
- Ycoord
- Grid element
- Manhole ID
- Time
- Pressure Head
- Rim elevation + Surcharge Elevation
- FLO-2D WSE.
**SEDCHAN.OUT**
The sediment transport routine will compute scour and deposition in the channel.
- Grid element
- Xcoord
- Ycoord
- Maximum deposition (ft or m)
- Maximum scour (ft or m)
- Final bed elevation difference (ft or m)
- Maximum water surface elevation (ft or m)
**SEDCONSERV.OUT**
The sediment transport conservation summary is listed by output interval.
- Time
- Inflow (cuft or cum)
- Floodplain storage (cuft or cum)
- Channel storage (cuft or cum)
- Street storage (cuft or cum)
- Outflow (cuft or cum)
- Conservation total (cuft or cum)
- Conservation percent (cuft or cum)
**SEDFP.OUT**
Similar to the SEDCHAN.OUT file, the floodplain scour and deposition are reported in the SEDFP.OUT file.
- Grid element
- Xcoord
- Ycoord
- Maximum deposition (ft or m)
- Maximum scour (ft or m)
- Final bed elevation difference (ft or m)
- Maximum water surface elevation (ft or m)
**SEDTRAN.OUT**
The sediment transport capacity (cfs or cms) computations for each of the eleven sediment transport equations are listed by output interval in this
file for a single specified grid element.
Set the variable to print the file in the SED.DAT file or with the FLO-2D Plugin.
- Zeller/Fullerton
- Yang
- Englund/Hansen
- Ackers/White
- Laursen
- Toffaleti
- MPM-Woo
- MPM-Smart
- Karim/Kennedy
- Parker/Klingemen/McClean
- Van Rijn
**SPECENERGY.OUT**
The specific energy is the sum of the depth plus the velocity head.
This file lists the maximum specific energy (ft or m) for a floodplain grid element and includes grid element number, grid element x- and
y-coordinates and maximum specific energy.
- Grid element
- Xcoord
- Ycoord
- Specific energy (ft or m)
**STATICPRESS.OUT**
The spatially variable static force per linear foot for each floodplain element is presented is this file by grid element number, x- and y-coordinates
and force per linear foot or meter.
- Grid element
- Xcoord
- Ycoord
- Static pressure (lb/ft or N/m)
**STEEPROUGH.OUT**
This file lists the final changes to Manning’s n-values for the grid elements with steep slopes.
- Grid element
- Receiving grid element
- Original n-value
- Max n-value
**STORMDRAIN_ERROR.CHK**
Storm drain error and warning messages are written to this file.
The error/warnings related to conflicts between storm drain features and surface components as well as the elevations checks are listed.
The Storm Drain Guidelines manual has a troubleshooting section that will help determine how the errors and conflicts can be corrected.
**STREET.RGH**
This file lists the final changes to Manning’s n-values for the street grid elements.
The maximum and final Manning’s n-values are reported in the ROUGH.OUT file.
If the n-value changes are acceptable, STREET.RGH can be renamed to STREET.DAT for the next FLO-2D flood simulation.
This automates the spatial adjustment of n-values for street elements that exceeded the limiting Froude number.
**STREET.OUT**
Similar to DEPTH.OUT, this file contains the street element x- and y- coordinates and the maximum street flow depth.
- Grid element
- Xcoord
- Ycoord
- Maximum street depth (ft or m)
**STRELEV.OUT**
Final street elevations used in the model simulation are listed in this file.
- Grid element
- Final street elevation (ft or m)
**SUMMARY.OUT**
This file lists the volume conservation summary table including the simulation output time interval, the minimum timestep and flood volume
conservation.
It also reports the inflow hydrograph, rainfall, infiltration loss, and outflow and storage volumes.
Review the volume conservation accuracy and the final distribution of volume in this file.
Mass balance information for the various flow components is reported.
- Inflows
- Inflow hydrograph volume
- Rainfall volume
- Storage
- Floodplain storage
- Channel storage
- TOL storage (see TOLER.DAT)
- Outflow
- Infiltration and interception
- Floodplain outflow
- Channel infiltration
Storm drain exchange volume is reported
- Storm drain inflow
- Total inflow
- Total outflow
- Storm drain return flow
- Storm drain mass balance Storm drain volume data from swmm.rpt
- Wet weather inflow
- External inflow
- External outflow
- Return flow to surface
- Total storm drain storage
- Continuity error Totals are reported
- Total outflow
- Total volume and storage
- Area of inundation data
- Wetted floodplain area
- Wetted channel area Project Specific Data
- Grid element siz
- Total number of grid elements
- Grid System area (acres or m\ :sup:`2` and mi\ :sup:`2` or km\ :sup:`2`) Average hydraulics
- Discharge (cfs or cms)
- Velocity (fps or cms)
- Flow area (ft\ :sup:`2` or m\ :sup:`2`)
- Flow depth (ft or m)
- Flow width (ft or m) Computation data
- Total Computations
- Computer run time (hrs)
- Termination date and time
**SUPER.OUT**
Instead of writing the supercritical flow messages at runtime (and limiting them to the first 100 or so instances), the maximum supercritical Froude
number (associated depth and time and number of occurrences) are tracked and sorted by Froude number in descending order at model termination for both
floodplain and channel (at the bottom of the file).
It also indicates if the grid elements are hydraulic structures.
By correlating this file with TIME.OUT, ROUGH.OUT, VELTIMEFP.OUT, the user can address the problematic elements with greater insight.
- Grid element
- Max Froude number
- Depth (ft or m)
- Time
- Number of supercritical timesteps
**SURFAREA.OUT**
The SURFAREA.OUT lists the available flow surface area in each grid element.
The area reduction factors (ARF) remove a portion of the surface area of a grid element to account for buildings or other features that occupy the
flow surface area.
Channels, streets and multiple channels also require a portion of the floodplain surface.
The remaining floodplain surface area is reported.
At the end of the file, the maximum area of floodplain inundation (including the channel surface area) for the entire grid system is listed by output
time interval.
This can be an informative data file for the user.
The SURFAREA.OUT file enables a review of the surface area distribution between the various components.
- Grid element
- Arf-reduced area - total area minus the building
- Channel area - bank elements covered by part of the channel
- Street area - area covered by street component
- Mult channel area - area covered by mult channel
- Overland area - remaining area not covered by a component
- Mult channels - switch tells the user this element has a mult channel.
**SWMM.OUT**
This is the binary file that contains the numerical results from a storm drain simulation.
View it with the storm drain interface (GUI) to create the time series plots and tables, profile plots, and statistical analyses.
For more information, look at: C:\\Users\\Public\\Documents\\FLO-2D PRO Documentation\\flo_help\\Manuals\\FLO-2D Storm Drain Manual.pdf.
**SWMM.RPT**
This file contains the report information and the results of the storm drain flood routing in ASCII Format.
The storm drain model engine generates this file.
It is extensive and contains discharge hydrographs for every drain inlet, outlet and conduit.
The Storm Drain Guidelines manual is the best resource for developing, troubleshooting and reviewing anything storm drain related.
For more information look at: C:\\Users\\Public\\Documents\\ FLO-2D PRO Documentation\\flo_help\\Manuals\\FLO-2D Storm Drain Manual.pdf.
**SWMMOUTFIN.OUT**
This file reports the storm drain outfall hydrographs for return flow to the surface water system.
This file lists the grid element (or channel element if applicable) followed by the time and discharge pairs.
The Storm Drain Guidelines manual is the best resource for developing, troubleshooting and reviewing anything storm drain related.
For more information look at: C:\\ Users\\Public\\Documents\\FLO-2D PRO Documentation\\flo_help\\Manuals\\FLO-2D Storm Drain Manual.pdf.
**SWMMQIN.OUT**
The discharge hydrograph and return flow (time, discharge and return flow) into each storm drain inlet of the pipe network is reported in this file.
Each inlet has a discharge hydrograph and return flow reported each output interval TOUT timestep.
The Storm Drain Guidelines manual is the best resource for developing, troubleshooting and reviewing anything storm drain related.
For more information look at: C:\\Users\\Public\\Documents\\ FLO-2D PRO Documentation\\flo_help\\Manuals\\FLO-2D Storm Drain Manual.pdf
**SD ManholePopUp.OUT**
This file reports the storm drain manhole nodes that have enough pressure head to pop off the manhole cover.
The pop off pressure head is an instantaneous head that removes the manhole cover.
This pressure head can be different to the reported pressure head in the SWMM.RPT file.
- Manhole ID
- Popped time
- Pressure head pop off must be greater than the following:
- Rim and surcharge head
- FLO-2D water surface elevation
**TIMDEP.OUT**
This file contains grid element, flow depth, velocity and velocity direction x and y and water surface elevation for each floodplain grid element at
the user specified time intervals (TIMTEP in CONT.DAT).
This file is also required for a time-lapse simulation in the MAXPLOT and FLO-2D MapCrafter post-processor programs.
Time - output interval for time series.
Single value at the top of the columns.
- Grid element
- Depth (ft or m)
- Velocity (sqrt(x\ :sup:`2` +y\ :sup:`2`)) (fps or mps)
- Velocity x - velocity vector x
- Velocity y - velocity vector y
- Water surface elevation (ft or m)
**TIMDEPCELL.OUT**
This file contains flow depth, velocity, and velocity direction x and y, and water surface elevation for a set of grid elements defined by the
TIMEDEPCELL.DAT file.
The user specifies time intervals with TIMTEP in CONT.DAT.
**TIMDEP.HDF5**
This binary output file contains grid element, flow depth, velocity and velocity direction x and y and water surface elevation for each floodplain
grid element at the user specified output time intervals (TIMTEP in CONT.DAT).
This file is written in binary format (HDF5) and it has the same results than the TIMDEP.OUT file.
**TIMDEP_NC4.OUT**
This file contains specific details for every grid element at each time series output interval.
The user specifies output time intervals with TIMTEP in CONT.DAT.
This is an ASCII file.
- Grid element
- Depth (ft or m)
- Qmax (cfs or cms)
- Qmax direction - grid element direction 1 - 8
- Vmax (fps or mps)
- Vmax direction - grid element direction 1 - 8
- Qnet - all flow in minus all flow out (cfs or cms)
- Surface Exchange - switch 0 or 1 identifies if cell had any flow for the time interval
**TIME.OUT**
The timestep is controlled by the numerical stability criteria.
When the stability criteria are exceeded for a particular grid element, the timestep is decreased.
The grid elements with the highest number of timestep decreases are written to the TIME.OUT file.
This file can be reviewed to determine if a specific floodplain, channel or street node is consistently causing the timestep decrease and what stability criteria is frequently being exceeded.
If one grid element has caused significantly more timestep decreases than the other grid elements, then its attributes and the attributes of the
contiguous grid elements should be carefully reviewed.
- Grid element - floodplain, channel, or street
- Number of timestep decrements
- Percent change in depth
- CFL Stability criteria
- Dynamic wave stability criteria
The file lists the last one hundred time step decreases and the node type.
**TIME_TO_ABOVE_BASEFLOW.OUT**
An option to report the time to discharge above channel base flow has been implemented.
The new file is generated with the following data columns.
- Grid
- Xcoord
- Ycoord
- Time to above baseflow (hrs)
This is a similar option as was coded for channel base flow.
This file required that the baseflow variable IBASEFLOW is assigned with the base discharge value.
This value represents the baseflow condition in a channel and the arrival time of any flow above that value is printed to this file.
**TIMEONEFT.OUT**
This file reports the grid element number, the x- and y-coordinates and the initial time to one foot of depth.
The time to one foot of depth can be plotted in FLO-2D MapCrafter.
This file is typically used for dam and levee breach analysis.
- Grid element
- Xcoord
- Ycoord
- Time to one ft depth
**TIMETOPEAK.OUT**
This file reports the grid element number, the x- and y-coordinates and the time of occurrence of the maximum depth.
This time to maximum depth can be plotted in FLO-2D MapCrafter.
While this file is typically used for dam and levee breach analysis, it valid for general flood studies.
- Grid element
- Xcoord
- Ycoord
- Time to one ft max depth
**TIMETWOFT.OUT**
This file reports the grid element number, the x- and y-coordinates and the initial time to two feet of depth.
The time to two feet of depth can be plotted in FLO-2D MapCrafter.
This file is typically used for dam and levee breach analysis.
- Grid element
- Xcoord
- Ycoord
- Time to two ft depth
**TOPO_SDELEV.RGH**
This file contains the elevation adjustments that were automatically corrected when the FLO-2D engine compared the floodplain grid elements to the
storm drain inlet rim and type 4 invert elevations.
To fully accept the changes reported to fprimelev.new, replace TOPO.DAT with this file.
It is also necessary to replace the FPLAIN.DAT with FPLSIN_SDELEV.RGH.
UPS-DOWS-CONNECTIVITY.OUT
This file reports the connectivity between the upstream domain grid elements and the downstream domain grid elements.
- Upstream grid element
- Downstream grid elements
**Velocity Output Files**
These files are similar to the DEPTH.OUT file.
These files contain the x- and y-coordinates and maximum velocities and can be viewed with the MAXPLOT or FLO-2D MapCrafter program.
- Grid element
- Xcoord
- Ycoord
- Velocity in the channel element (fps or mps)
The velocity output files include:
STVEL.OUT - Maximum street flow velocity;
STVELDIR.OUT - Flow direction of the maximum street flow velocity;
VELFP.OUT - Maximum floodplain flow velocity;
VELOC.OUT - Maximum channel flow velocity;
VELCHFINAL.OUT - Final channel flow velocities;
VELDIREC.OUT - Flow direction of the maximum floodplain flow velocity;
FINALVEL.OUT - Flow velocity at the end of the simulation;
FINALDIR.OUT - Flow maximum velocity direction at the end of the simulation;
VEL_X_DEPTH.OUT - The velocity x depth parameter is evaluated as a single variable.
This is not max velocity x max depth, it is the maximum value of the velocity squared x depth that is synchronized by time.
VEL_SQUARED_X_DEPTH.OUT - The velocity squared x depth parameter is evaluated as a single variable.
This is not max velocity squared x max depth, it is the maximum value of the velocity squared x depth that is synchronized by time.
The velocity output files related to two-PHASE flow include:
FINALDIR_MUD.OUT - Floodplain final mudflow velocity direction.
FINALVEL_MUD.OUT - Floodplain final mudflow velocity in the reported outflow direction.
VELDIREC_MUD.OUT - Floodplain maximum mudflow velocity direction.
VELFP_MUD.OUT - Floodplain maximum mudflow velocity in the reported outflow direction.
VELOC_MUD.OUT - Channel maximum mudflow velocity.
VELRESMAX_MUD.OUT - Floodplain maximum resolved mudflow velocity in the computed outflow direction.
VEL_X_DEPTH.OUT - The velocity x depth parameter is evaluated as a single variable (not maximum velocity times maximum depth).
For two phase, the velocity x depth variable is the maximum value for the grid element for either fluid or mudflow whichever is greater.
FPWSEL_MUD.OUT - Floodplain maximum mudflow water surface elevation.
- Grid or Channel Left Bank Element
- Xcoord
- Ycoord
- Variable
**VELTIMEC.OUT**
This file lists the grid element number, maximum channel velocity and the time of occurrence.
It is sorted from highest to lowest velocity so that an examination of the first several lines
of output data will determine if there are any unreasonably high maximum channel velocities.
- Grid element
- Vmax in the channel element (fps or mps)
- Time of occurrence
**VELTIMEFP.OUT**
This file lists the first 100 floodplain elements: number, maximum floodplain velocity and the time of occurrence.
It is sorted from highest to lowest velocity so that an examination of the first several lines of output data will determine
if there are any unreasonably high maximum floodplain velocities.
- Grid element
- Vmax floodplain element (fps or mps)
- Depth floodplain element (ft or m)
- Time of occurrence
**VELRESMAX.OUT**
This file lists the maximum resolved velocities as a vector field.
It is not based on the 8-flow directions.
- Grid element
- Xcoord
- Ycoord
- Velresmax (fps or mps)
- Velxmax
- Velymax
Flow velocities are computed in 8-directions for each grid element.
In the figure below, the red arrows indicate inflow to the grid element (2-directions) and the blue arrows represent outflow from
the grid element (3-directions).
The remaining flow directions have zero discharge and velocities.
The arrow length indicates relative magnitude.
If the outflow velocities from the grid element are resolved into x- and y- coordinate directions, the components would be depicted by the blue arrows
in the figure below.
The resultant velocity vector for the outflow from the grid element would then be represented by the green arrow.
**VELTIMEST.OUT**
This file lists the street element number, maximum street velocity and the time of occurrence.
It is sorted from highest to lowest velocity so that an examination of the first several lines of output data will determine
if there are any unreasonably high maximum street velocities.
- Grid element
- Vmax street element (fps or mps)
- Time of occurrence
**WSTIME.OUT**
If the WSTIME.DAT file is created, the WSTIME.OUT file will be generated listing the channel element number, time of the measured water surface
elevation, measured water surface elevation at stated time, predicted water surface elevation at stated time, difference between the water surface
elevations and the cumulative difference between the measured and predicted water surfaces.
**XSECAREA.OUT**
When the channel cross-section option is invoked for channel routing, the channel geometry data is written to this file.
It includes: grid element, flow area, top width and wetted perimeter for the lowest top of bank (bankfull flow).
- Grid element
- Flow area of the cross-section (sqft or sqm)
- Top width of the cross-section (ft or m)
- Wetted Perimeter of the cross-section (ft or m)
**XSEC.OUT**
This file is created by the channel sediment transport option (ISED = 1 in CONT.
DAT and ISEDN = 1 for a channel segment in CHAN.DAT) for natural cross-section geometry data.
It contains the final cross-section bed elevations after scour and deposition have been computed.
The file looks the same as XSEC.DAT with updated elevation data.